.NET MAUI

단일 프로젝트 구조는 .NET MAUI의 핵심 설계 철학 중 하나이다. 이전의 Xamarin.Forms에서는 Android, iOS, Windows 등 각 대상 플랫폼마다 별도의 프로젝트 파일을 생성하고 관리해야 했다. 반면 .NET MAUI는 하나의 프로젝트 파일(.csproj) 내에서 모든 플랫폼을 위한 코드, 리소스, 설정을 통합하여 관리한다.

이 구조는 개발 워크플로우를 크게 단순화한다. 개발자는 공유 코드를 중심으로 앱을 개발하고, 플랫폼별로 차이가 필요한 리소스(예: 아이콘, 스플래시 스크린)나 코드는 프로젝트 내의 Platforms 폴더 하위에 각 플랫폼 이름(Android, iOS, MacCatalyst, Windows)으로 구분된 디렉터리에 배치하면 된다. 빌드 시스템이 자동으로 해당 플랫폼에 맞는 파일을 선택하여 패키징한다.

단일 프로젝트의 장점은 명확하다. 솔루션의 복잡성이 감소하고 프로젝트 관리가 용이해진다. 또한 Visual Studio나 .NET CLI를 통한 빌드 및 배포 과정이 통일되어, 여러 플랫폼을 대상으로 한 빌드 명령이 간소화된다. 이는 CI/CD 파이프라인 구축 시에도 이점으로 작용한다.

이러한 구조는 Xamarin.Forms에서 .NET MAUI로의 주요 진화 중 하나로, 진정한 단일 코드베이스 크로스 플랫폼 개발 경험을 제공하는 데 기여한다. 결과적으로 개발자는 플랫폼 간의 차이보다는 앱의 핵심 비즈니스 로직과 UI 설계에 더 집중할 수 있게 된다.

.NET MAUI의 플랫폼별 렌더링은 개발자가 작성한 단일 사용자 인터페이스 코드를 각 대상 운영 체제의 네이티브 컨트롤로 변환하여 그리는 핵심 메커즘이다. 이는 기존 Xamarin.Forms가 각 플랫폼의 네이티브 API를 직접 호출하는 방식에서 발전한 것으로, .NET MAUI는 중간 계층인 핸들러(Handler)를 도입하여 추상화 수준을 높였다.

핸들러 아키텍처에서는 MAUI의 추상 컨트롤(예: Button)이 각 플랫폼별 핸들러(Android의 ButtonHandler, iOS의 ButtonHandler)에 매핑된다. 이 핸들러는 최종적으로 해당 플랫폼의 네이티브 뷰(Android의 AppCompatButton, iOS의 UIButton)를 생성하고 속성을 연결한다. 결과적으로 개발자는 MAUI의 공통 API만을 사용하지만, 실행 시에는 각 Windows, Android, iOS, macOS 앱이 해당 플랫폼 고유의 모양과 느낌을 그대로 유지하게 된다.

이러한 설계는 플랫폼별 맞춤 렌더링이 필요한 경우에도 유연성을 제공한다. 개발자는 특정 컨트롤의 핸들러를 완전히 재구성하거나 부분적으로 수정하는 커스텀 핸들러를 작성할 수 있다. 이를 통해 대부분의 코드는 크로스 플랫폼으로 공유하면서도, 특정 플랫폼에서만 필요한 고급 사용자 정의나 최적화를 구현하는 것이 가능해진다.

.NET MAUI의 호스트 빌더 패턴은 .NET 6 이상의 일반적인 호스트 모델을 기반으로 한 애플리케이션 부트스트랩 및 생명주기 관리 방식을 채택한다. 이 패턴은 애플리케이션의 시작 지점에서 MauiApp과 MauiAppBuilder를 사용하여 서비스 구성, 의존성 주입, 로깅 설정 등을 중앙 집중식으로 관리할 수 있게 한다. 기존 Xamarin.Forms의 App 클래스 중심 방식에서 진화하여, .NET Generic Host의 유연성과 확장성을 크로스 플랫폼 GUI 앱 개발에 도입한 것이 핵심이다.

이 패턴을 통해 개발자는 MauiProgram 클래스 내에서 CreateMauiApp 정적 메서드를 정의하고, MauiApp.CreateBuilder()를 호출하여 빌더를 구성한다. 이 빌더를 사용하여 앱에 필요한 서비스(예: 데이터베이스 접근 계층, 네트워킹 클라이언트)를 등록하고, 폰트 또는 앱 아이콘과 같은 리소스를 설정한 후, 최종적으로 Build() 메서드를 호출하여 애플리케이션 호스트를 생성한다. 이 구조는 웹 개발에 사용되는 ASP.NET Core의 호스트 모델과 개념적으로 유사하여, 마이크로소프트의 .NET 생태계 전반에 걸친 일관된 개발 경험을 제공한다.

호스트 빌더 패턴의 주요 장점은 애플리케이션의 초기화 코드가 체계적으로 정리되고 테스트하기 쉬워진다는 점이다. 또한, 개발 환경(개발/스테이징/프로덕션)에 따라 다른 구성을 쉽게 주입하거나, 의존성 주입 컨테이너를 활용한 모듈식 설계가 용이해진다. 이는 Windows, Android, iOS, macOS 각 플랫폼별로 특화된 설정이나 서비스 등록이 필요할 때도 일관된 인터페이스로 처리할 수 있도록 돕는다. 결과적으로, 호스트 빌더 패턴은 .NET MAUI 애플리케이션의 기반 구조를 더욱 견고하고 유지보수하기 쉽게 만드는 데 기여한다.

.NET MAUI 애플리케이션 개발의 주요 통합 개발 환경은 마이크로소프트의 Visual Studio이다. Visual Studio 2022 버전 17.3부터 .NET MAUI 개발을 공식적으로 지원하며, 이를 통해 개발자는 Windows에서 Android, iOS, macOS를 대상으로 하는 앱을 하나의 프로젝트 내에서 개발하고 디버깅할 수 있다.

Visual Studio 내에서 .NET MAUI 개발을 위해 필요한 워크로드인 ".NET Multi-platform App UI 개발"을 설치해야 한다. 이 워크로드는 .NET SDK, 플랫폼별 에뮬레이터 및 시뮬레이터 구성 도구, 필수 라이브러리 등을 포함하여 개발 환경을 한 번에 설정할 수 있게 해준다. Visual Studio의 강력한 디자이너, IntelliSense, 통합 디버거, 프로파일링 도구 등을 활용할 수 있어 생산성이 크게 향상된다.

주요 개발 기능으로는 핫 리로드가 있다. .NET MAUI는 .NET의 핫 리로드 기능을 지원하여, 앱을 다시 빌드하거나 재시작하지 않고도 코드나 XAML UI 변경 사항을 실행 중인 앱에 실시간으로 적용해볼 수 있다. 또한, Visual Studio는 연결된 Android 장치나 에뮬레이터, iOS 시뮬레이터, Windows 자체를 동시에 여러 개 선택하여 단일 빌드로 모든 대상에 배포하고 실행하는 멀티 디바이스 디버깅을 지원한다.

Visual Studio 외에도 .NET CLI(명령줄 인터페이스)를 사용하여 프로젝트 생성, 빌드, 배포 등의 작업을 수행할 수 있으며, 이는 지속적 통합 및 지속적 배포 파이프라인에 통합하거나 다른 코드 편집기(Visual Studio Code 등)와 함께 사용할 때 유용하다.

.NET MAUI 애플리케이션 개발은 Visual Studio와 함께 .NET CLI를 사용하여 수행할 수 있다. .NET CLI는 명령줄 인터페이스로, 개발자가 터미널이나 스크립트 환경에서 프로젝트 생성, 빌드, 실행, 게시 등의 작업을 처리할 수 있게 해준다. 이는 특히 자동화된 빌드 파이프라인이나 CI/CD 환경에서 유용하게 활용된다.

.NET MAUI 프로젝트를 CLI로 생성하려면 dotnet new maui 명령어를 사용한다. 이후 dotnet build 명령으로 애플리케이션을 빌드하고, dotnet run 명령을 통해 특정 시뮬레이터나 연결된 실제 디바이스에서 앱을 실행할 수 있다. CLI를 통한 개발은 Visual Studio Code와 같은 경량 코드 에디터를 주 개발 도구로 사용하는 개발자들에게 필수적인 환경을 제공한다.

또한 .NET CLI는 NuGet 패키지 관리, 프로젝트 구조 확인, 다양한 대상 플랫폼에 대한 게시 명령어도 지원한다. 이로 인해 .NET MAUI는 통합 개발 환경과 명령줄 도구 모두에서 강력한 개발 경험을 제공하는 것이 특징이다.